home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / GNU / ags_000.lha / README.AMIGA < prev   
Encoding:
Text File  |  1993-07-16  |  6.3 KB  |  167 lines
  1. Subject: Amiga Ghostscript for Intuition & RETINA
  2. Class: util/gnu
  3. Uploader: ah@rbg.informatik.th-darmstadt.de
  4.  
  5.  
  6. This file is part of Ghostscript.
  7.  
  8. Ghostscript is distributed in the hope that it will be useful, but
  9. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  10. to anyone for the consequences of using it or for whether it serves any
  11. particular purpose or works at all, unless he says so in writing.  Refer
  12. to the Ghostscript General Public License for full details.
  13.  
  14. Everyone is granted permission to copy, modify and redistribute
  15. Ghostscript, but only under the conditions described in the Ghostscript
  16. General Public License.  A copy of this license is supposed to have been
  17. given to you along with Ghostscript so you can know your rights and
  18. responsibilities.  It should be in a file named COPYING.  Among other
  19. things, the copyright notice and this notice must be preserved on all
  20. copies.
  21.  
  22. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  23.  
  24. ***********************************************************************
  25. * This file describes the additional device drivers of the amiga port *
  26. ***********************************************************************
  27.  
  28.  
  29. The 'intui' device
  30. ------------------
  31.  
  32. The intui device was written by Markus (Landi) Landgraf.
  33.  
  34. The intui device is similar to the X device on UNIX stations.  When
  35. ghostscript is invoked with this device chosen, it opens an Amiga
  36. Intuition window with system gadgets and two scroller Gadgets. The
  37. scroller gadgets are meant to scroll through an output that's bigger
  38. than the window ( this is normally the case, because the standard size
  39. of the intuition device is dinA4, wich is bigger than for example a
  40. 15''-Monitor). To use the intui device as default, set the environment
  41. variable 'GS_DEVICE' to 'intui'. The intui device should not disturb
  42. the workbench colors, so it was only possible to make a black and
  43. white display of the output with the darkest workbench color as black
  44. and the brightest as white.  When the output in the window seems
  45. bended, the default settings for device-resolution are no more valid,
  46. the user has to compute it from the size and pixels of her/his display
  47. and set it by the -r option of ghostscript (see use.doc).
  48.  
  49. -------------------------------------------------------------------
  50.  
  51. NAME
  52.   ilbm-retina.doc
  53.  
  54. DATE
  55.   Mar-27 1993
  56.  
  57. DESCRIPTION
  58.   Documentation for ILBM and RETINA drivers
  59.  
  60. AUTHOR
  61.   Andreas Heitmann
  62.   Kasseler Str. 67
  63.   34308 Emstal 1
  64.   Germany
  65.  
  66. EMAIL
  67.   andreas@gotcha.swb.de
  68.   ah@hrz-serv7.hrz.uni-kassel.de
  69.   ah@rbg.informatik.th-darmstadt.de
  70.   heitmann@crunch.ikp.physik.th-darmstadt.de
  71.  
  72. RETINA DOCUMENTATION
  73.  
  74.   The RETINA driver for Ghostscript is only useful for the Amiga
  75.   platform, because the RETINA-hardware does only exist for this
  76.   computer. The driver supports all display modes, but there
  77.   are still bugs in the retina.library which make the 16 bit
  78.   mode useless.
  79.   To display a Postscript picture on a RETINA screen you have to
  80.   set the output device using the Ghostscript command
  81.   line switch 
  82.  
  83.     -sDEVICE=retinaXX
  84.  
  85.   where XX has to be replaced by 8,16 or 24 corresponding to 
  86.   the desired number of BitPlanes. The resolution of the RETINA
  87.   screen is determined from the settings of the RetinaScreenmode
  88.   program.
  89.  
  90.   If you want to use the RETINA-driver by default, you can do this 
  91.   by setting the environment-variable GS_LIB to 'retinaXX'.
  92.  
  93.   After starting Ghostscript with the RETINA device, the page will
  94.   be rendered with the maximum screen size or with the specified
  95.   geometry.
  96.  
  97.   You will observe a remarkable slow down if you render a picture
  98.   with 8 bit CLUT compared to 24 bit. One reason is, that Ghostscript
  99.   has to maintain the CLUT and eventually do the dithering if it runs
  100.   out of colours. The other reason is a bug in the FillRect()-Function
  101.   of the retina.library which makes rectagle filling impossible in the
  102.   8 bit mode. Instead i had to use DrawLine() to fill rectangles.
  103.  
  104.   This bug is fixed in Version 3.8 of retina.library which is contained
  105.   in the update package V1.2, but i won't change the DrawLine-Kludge
  106.   for the next few weeks.
  107.  
  108.  
  109. ILBM DOCUMENTATION
  110.  
  111.   The ILBM driver is a Ghostscript device for converting Postscript
  112.   to the commonly used IFF-ILBM files. This standard file format has
  113.   been defined by Electronics Arts and allows a variable number of
  114.   bitplanes and a simple form of image compression.
  115.  
  116.   There are currently two ilbm devices, which are writing output
  117.   files with a different number of bitplanes, namely the 'ilbm8' device
  118.   which uses a 256 color palette, and the true color 'ilbm24' device
  119.   which writes a 24 bit non-CLUT iff file.
  120.  
  121.   Each mode always uses runlength compression, which in most cases
  122.   makes output files shorter.
  123.  
  124.   There is still a bug in the output routines, which makes the
  125.   request ">>showpage, press <return> to continue<< appear after
  126.   writing the file. You can avoid this by piping NIL: into
  127.   Ghostscript or setting the flag -dNOPAUSE. It may also be
  128.   possible that multi-page output does not work in the current
  129.   version of there ILBM-driver, i don't know if it is allowed
  130.   to put more than one picture in an ILBM file.
  131.  
  132.   I decided to use the Amiga iffparse.library for writing IFF-files,
  133.   so this implementation has two problems: you can't compile in on
  134.   other machines without a replacement for the iffparse.library.
  135.   This is rather hard to fix, if you really want to compile on
  136.   a non-Amiga platform, you have to rewrite the code.
  137.  
  138.   The other problem can be fixed, it arises from the stream management
  139.   the library uses. It is easy to work with the AmigaDOS functions for
  140.   writing files, but GCC implements a slightly different filesystem
  141.   for compatibility with UN*X. It is possible to use the GCC 
  142.   buffered I/O-functions together with the iffparse.library, but
  143.   the price is high: i would have to write assembler inline code,
  144.   which is not very portable nor easy to understand.
  145.  
  146.   So in contrast to other Ghostscript devices, the ILBM-driver uses
  147.   AmigaDOS pathname conventions: full pathnames contain colons, an
  148.   a an initial slash means parent directory, not root directory.
  149.  
  150.  
  151. BUG REPORTS
  152.  
  153.   Bug reports and improvements are welcome, send them to my address
  154.   in the header (EMail preferred).  
  155.  
  156.  
  157. Have fun with Ghostscript,
  158.  
  159.   Andreas
  160.  
  161.      - --  O  
  162.     - --  /   
  163.   --  ***/\=+c
  164.   - - /\*\**/\
  165.       \/ /  \/<
  166.  
  167.  & Landi